home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / osr5 / dist / smail-3.1.29.1.README < prev    next >
Text File  |  1998-03-24  |  5KB  |  100 lines
  1. This is a port of smail 3.1.29.1 to SCO Open Server 5.0. This is a binary
  2. only distribution, and has 8-bit MIME support, ESMTP and other optional
  3. features compiled in. Be VERY careful when installing this package, and
  4. test its installation well.
  5.  
  6. *** IT IS HIGHLY RECOMMENDED THAT YOU DO THIS IS SINGLE USER MODE ***
  7. *** AND THAT YOU HAVE A COMPLETE SYSTEM BACKUP BEFORE PROCEEDING  ***
  8.  
  9. Before extracting you MUST cd /bin and type:
  10. mv mail lmail, then to extract this archive, as root, do the following:
  11. # cd /
  12. # gzcat smail-3.1.29.1.tar.gz | tar xf -
  13. This will extract the distribution into the /usr hierarchy.
  14.  
  15. Before extracting this software, you should first remove both MMDF and
  16. Sendmail from your system completely. You can still use the standard SCO
  17. mail user tools, although better tools are vailible freely. I strongly
  18. suggest you use PINE or ELM (and of the two, PINE is more powerful).
  19. You will find both tools on the same site you found this archive.
  20.  
  21. One of the side-effects of removing the mail transports from custom is
  22. that your mail spool directory can be removed. There is an entry in
  23. this archive to create it with the permissions smail expects. If you
  24. do have an existing /var/spool/mail, I suggest you back it up before
  25. you begin installing smail.
  26.  
  27. Once you have extracted the archives, there are several things you
  28. must set up. The first is to arrange to have identd run. To do this,
  29. edit /etc/services, and change the entry for port 113 to be:
  30. ident    113/tcp        auth tap authentication
  31. Next, edit /etc/inetd.conf and add the line (or edit any existing
  32. line which related to RFC1143 authentication) to:
  33. ident    stream    tcp    nowait    root    /etc/identd in.identd
  34.  
  35. If there are any entries in inetd.conf relating to smtp, remove them.
  36.  
  37. Next, you must edit /etc/tcp to arrange for smail to be run when TCP/IP
  38. is started up. To do this, add an entry called 'sendmail' to the ALLPROCS
  39. list at the top of the file. Them at or near line 229 of the file, just
  40. after the checks for lpd, add the following lines:
  41.  
  42.     if [ -x /usr/lib/sendmail -a -f /usr/lib/smail/config ]; then
  43.         /usr/lib/sendmail -bd -q5m
  44.         echo "sendmail \c"
  45.     fi
  46.  
  47. The parameter -bd is VITAL, unless you are arranging to have sendmail
  48. run by inetd, which is NOT recommended. The -q5m parameter will tell
  49. smail to examine the pending out-going queue every 5 minutes. You can
  50. change this to something like -q1h30m or -q1d ... see the smail man
  51. pages for examples.
  52.  
  53. Next, you must edit /usr/lib/smail/config and tailor it according
  54. to your needs. I have left my config file exactly as it stands.
  55. Consult the man pages in /usr/lib/smail/man, and the administration
  56. guide in /usr/lib/smail/guide. If you do not have nroff, you can view
  57. pre-formatted versions of these files in /usr/lib/smail/preformat.
  58. smail.5 is the most important of the lot, as it explains all the
  59. config files. The file admin.txt in preformat is a very useful
  60. document to read.
  61.  
  62. Next, edit /usr/lib/smail/routers. You must decide how smail is to
  63. look up host names. You have two options, either using DNS/BIND or
  64. using the gethostbyname() system call. I suggest you use the BIND
  65. router (which is set by default) if at all possible. If you want to
  66. use gethostbyname, you must comment out the entry for inet_hosts
  67. which uses 'driver-bind' and un-comment the one which uses
  68. gethostbyname. While editing this file, decide how smail is to
  69. handle mail to hosts it doesnt know, but setting up the smart_host
  70. driver. You can have your smart host contacted by SMTP or UUCP. 
  71. Please consult the smail documentation for more details.
  72.  
  73. Ensure that /var/spool/mail has permissions 1777 and is owned by
  74. user root, group mail.
  75.  
  76. Once all of this has been done, attempt a simple test by executing:
  77. /usr/bin/smail -bv -v100 root
  78. This will produce a great deal of output, but at the end, you
  79. should see 'root ... deliverable'. If you have aliased root to 
  80. some other user, that user's name will appear. To set up aliases,
  81. you must edit the file /usr/lib/aliases, which is a normal text file.
  82. Once you have editing the aliases to your liking, run the program
  83. /usr/lib/smail/newaliases.
  84.  
  85. As a final test, ensure that smail is running by executing:
  86. /usr/lib/sendmail -bd -q5m
  87. and then type: telnet localhost 25
  88. You should see something about 'Smail 3.1.29.1 #4 ready'. Type
  89. QUIT to exit.
  90.  
  91. One word of warning. By default, smail does not accept delivery
  92. of very large messages. Be sure to set max_message_size in your
  93. config file.
  94.  
  95. Setting up smail is a worth-while but complex operation. Please be sure
  96. to read ALL the documentation and to consult the appropriate news
  97. groups before asking me questions. I am a smail user, not a smail
  98. support person. For good samples, see /usr/lib/smail/samples
  99.  
  100.